home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1998 January / EnigmA AMIGA RUN 24 (1997)(G.R. Edizioni)(IT)[!][issue 1998-01 & 02].iso / EARCD / DEMO / MSE-DEMO / Readme-FIRST.demo < prev    next >
Text File  |  1997-06-28  |  10KB  |  213 lines
  1.  
  2.                          MIDI SYStem EXplorer
  3.                               -- DEMO --
  4.  
  5.  
  6. Requirements
  7. ------------
  8. This demo uses fonts included with WB: Garnet.16 and Helvetica.9.
  9.  
  10.  
  11. Installing
  12. ----------
  13.  
  14. Copy fonts/ to your FONTS: directory.  The included Topaz2, Topaz2p,
  15. and Topaz2N fonts are designed for use with the demo modules.  These
  16. modules have been defined to use these fonts, but they are not
  17. necesarily required for custom modules you create.  Topaz2 is a nicer
  18. looking version of Topaz, Topaz2p is a proportional version of Topaz2,
  19. Topaz2N is a narrow version of Topaz2.
  20.  
  21.  
  22. Getting Started - TUTORIAL
  23. --------------------------
  24.  
  25. Double-click on the MSE-DEMO icon.
  26.  
  27. When MSE starts, you will be prompted with a file requester to choose a
  28. module to load.  Enter the Oberheim directory and select the
  29. Matrix-6R.mse module.
  30.  
  31. This is a demo of an editor for the Matrix-6R, but does not require
  32. this device.  Though all MIDI is disabled it demonstates several
  33. features of MSE.
  34.  
  35. Click in the string gadget containing "--------" at the top middle of
  36. the screen.  This is a gadget defined to contain the patch name for
  37. this patch.  Because almost all patch names are required to be a
  38. constant length this gadget is forced to be in OVERWRITE mode and will
  39. not allow you to DEL characters.  Try it!
  40.  
  41. Many manufacturers use different character sets for their devices. Some
  42. do not allow lowercase letters while others do.  MSE allows you to
  43. define what the character set contains for every module you create.
  44. Curious about what characters are supported by this module?  While in
  45. the patch name gadget press the HELP key (3.x only).  A requester will
  46. pop up showing you what characters are supported.  Notice that
  47. lowercase letters are not shown for this device.  For your convenience,
  48. lowercase letters will be automatically converted to uppercase for this
  49. device. Also, you will not be allowed to enter any characters that are
  50. not allowed.  Try it!
  51.  
  52. The cycle gadget in the upper left hand corner labled "DCO 1 / 2" is
  53. configured to flip through several pages of parameters.  Try it!  MSE
  54. uses system gadgets so its cycle gadgets are compatible with patches
  55. like CycleToMenu.  This patch, in particular, really enhances the speed
  56. of making patches in MSE.
  57.  
  58. Note that you could, if you wanted to, redefine/reposition anything you
  59. see.  Of course you will need the compiler included with the registered
  60. version of MSE to do it.
  61.  
  62. Play with the gadgets on these pages, change lots of values!  Now, if
  63. you decided that the current values were what you wanted every new
  64. patch to default to you simply go to the PROJECT menu and select SAVE
  65. AS DEFAULT. Try it.  Now whenever you restart this editor, these
  66. settings will be the default.
  67.  
  68. Let's load an existing patch... go to the PROJECT menu and select LOAD.
  69. When prompted with the file requester choose the PATCHES directory and
  70. select 'Matrix6R-Patch1'.  This patch is loaded and returns to the
  71. first page of parameters.  If this was not a Matrix6R patch, you would
  72. have been told so, and the patch would not have been loaded.
  73.  
  74. In a future version, MSE will automatically recognize the patch type
  75. and load the appropriate editor along with the patch!  NEETO!
  76.  
  77. To start with a fresh patch, go to the PROJECT menu and select LOAD
  78. DEFAULT.  Note that any time you load a patch, MSE automatically
  79. performs a defined initialization routine.  For each module you can
  80. define what the intialization includes.  Normally this would include
  81. sending the patch to a predefined audition patch on the device.  You
  82. can also manually send a patch by going to the PROJECT menu and
  83. selecting SEND.  Though, in the demo, this will not do anything.
  84.  
  85. Now let's check out the PREFS... goto the PREFS menu and select MIDI
  86. CONFIGURATION.  These can be defined within each module.  Check out the
  87. HANDLER gadget... MSE currently supports standard BlueRibbon.library
  88. use, the 3 outputs of the Triple Play Plus midi interface, the public
  89. domain MIDI.library, Commodores CAMD.library and a special FILE type. 
  90. FILE is used for testing purposes and sends all MIDI output to a file. 
  91. This makes things much easier when testing new modules.  As well, you
  92. can override the defined MIDI channel here.  Note that for this device
  93. all channels (1-16) are supported.  Some devices, such as the Akai S612
  94. do not support all 16 channels.  If that were the case you can
  95. configure this gadget to only allow the supported channels.  Remember,
  96. this setting and all others are specific to each module.
  97.  
  98. Reposition the MIDI CONFIGURATION window to some where else on the
  99. screen and then close it.  Now, open it again.  Notice that it
  100. remembers its new position.  If you want MSE to remember this the next
  101. time you use it, goto the PREFS menu and select SAVE.  SAVE stores the
  102. window configurations as well as directory paths and other preferences
  103. information.
  104.  
  105. Now, let's check out another module.  Goto the MODULE menu and select
  106. OPEN.  In the file requester, choose the TEST directory and select the
  107. 'Test.mse' module.  This module is not an editor for a MIDI device.  It
  108. just serves to demonstrate some of the different kinds of things you
  109. can define: Borderless and non-borderless windows, borders, different
  110. size fonts, etc.  Note the custom slider gadget near the center, it is
  111. labeled "Special Gadget".  It is similar to a cycle gadget in that it
  112. contains several different text values.  Also the gadget below it,
  113. which defaults to '-6.9db'.  This is another custom gadget which
  114. supports floating point values with any incremental value you want. MSE
  115. also supports several other custom gadgets that are designed
  116. specifically to meet the needs of MIDI devices.
  117.  
  118. The window that says 'Drag me!' has been defined as a draggable window.
  119. Use its drag bar to move it anywhere you want.  This window also
  120. contains another custom gadget (the Note gadget).  It is used for
  121. setting parameters such as note ranges.  It has actually been defined
  122. to display the current value in two different ways, so you'll see two
  123. values updating as you change the value.
  124.  
  125. One of the best features of MSE is automation.  To see it in action
  126. click on the 'Automate' gadget in the upper left hand corner.  This
  127. gadget has been linked to an external ARexx script which will do some
  128. fun things with the gadgets in this module.
  129.  
  130. In a future version, popup windows will also be definable.  These
  131. special windows will be triggered from button gadgets.  For example,
  132. the Note gadget popup window will contain a graphic keyboard that you
  133. can select notes on. When you close the popup-window the value will be
  134. displayed as it is now. These kinds of popups will support many kinds
  135. of parameters: including envelopes, lists, etc.  This support is in the
  136. works now and will be ready soon.
  137.  
  138. Notice that most of the menu selections under the PROJECT menu are now
  139. ghosted.  That is because the TEST module does not contain a definition
  140. for patch data.  MSE recognized this and disabled the menus that did
  141. not apply.  NIFTY EH!
  142.  
  143. MSE also recognized that this module contains special USAGE
  144. information.  Goto the MODULE menu and select USAGE.  This can come in
  145. handy when you need to remember something important to use this editor.
  146. You can define whatever text you want to appear here.  HANDY!
  147.  
  148. Okay, lets try one more module.  Go to the MODULE menu and select OPEN.
  149. In the file requester, choose the 'Roland' directory, then choose the
  150. 'SDX-330' directory and select the 'Stereo8PhaseChorus.mse' module. 
  151. Note that the MSE-Compiler automatically creates these directories for
  152. you, based on the modules you create.  This helps keep things
  153. organized. If you wanted to, you could make a custom module to load
  154. modules.  Then you could tell MSE to always load that specific module
  155. upon startup.  MSE is very powerful indeed!
  156.  
  157. Okay, now that we have loaded the SDX-330 module let's see what other
  158. neet things MSE can do... Down near the bottom right hand corner, there
  159. is a cycle gadget marked 1-4.  This is a special gadget that is defined
  160. to control multiple pages (much like the one you tried earlier).  Cycle
  161. it and MSE jumps to the next page of Chorus parameters 5-8.  Notice
  162. that only that particular area of the screen changed.  There is another
  163. cycle page selector at the top left corner, second row, marked 'Chorus'
  164. (not the one marked 'Stereo 8 Phase Chorus', that one will be explained
  165. next.) Cycle it, and it flips pages too.  Super Neeto!  The cycle
  166. gadget above that one marked 'Stereo 8 Phase Chorus' is defined to
  167. select modules.  Because the SDX-330 has many effects modes each effect
  168. type has been broken up into separate modules.  This cuts down on
  169. memory requirements for this editor. You could make it all into one
  170. module if you wanted to, but it would have 100s of gadgets and many
  171. many pages.  This is the recommended way of handling devices of this
  172. kind.  Because we have not included the other SDX-330 modules with the
  173. demo cycling this gadget will give you an error.
  174.  
  175. That concludes the DEMO TUTORIAL.  It only touchs on the many things
  176. you can do with MSE.  And there is much more yet to come!  We have
  177. included a few other demo modules as well, try them out.
  178.  
  179. We have also included some definition files used to create the demo
  180. modules in the definitions directory.  They are simple text files, have
  181. a look!
  182.  
  183. So are you hooked yet?  Excited about the creative possibilities?
  184.  
  185. For a limited time, MSE will be available for the low shareware
  186. registration price of US$30 (CAN$40).  After registering, any following
  187. updates will be free to those with email access.
  188.  
  189. Print and complete the Registration.txt form and send it along with
  190. payment to (Make checks or money orders payable to 'dhomas trenn'):
  191.  
  192.                            young monkey studios
  193.                             797 Mitchell Street
  194.                               Fredericton, NB
  195.                              E3B 3S8    CANADA
  196.  
  197. We suggest that you send us a copy of the SYSEX docs for the units you
  198. want to make modules for (check with us first to see if we already have
  199. the info).  We will have a look at the documentation and confirm that
  200. MSE supports everything required by that unit.  If it does not, we can
  201. try and implement it at that time.  That way, you do not have to spend
  202. your money until the program meets your needs.
  203.  
  204.  
  205. For more information send email to:
  206.  
  207.    MSE@youngmonkey.ca
  208.  
  209.  
  210. ----
  211. dhomas trenn
  212. young monkey studios
  213.